home *** CD-ROM | disk | FTP | other *** search
/ C/C++ Users Group Library 1996 July / C-C++ Users Group Library July 1996.iso / vol_400 / 420_01 / coerce.doc < prev    next >
Text File  |  1994-04-09  |  5KB  |  143 lines
  1. Subject: Re: coerce
  2. Date: Thu, 24 Feb 94 01:07:00 +0900
  3. From: Tatsuro Sekiguchi <cocoa@is.s.u-tokyo.ac.jp>
  4.  
  5. Dear Mr. Volkman,
  6.  
  7. Thank you for your attention to my software. I am delighted to accept
  8. your request that coerce would be added to CUG Library. It is my
  9. pleasure that my software can serve many programmers.
  10.   But I have had a slightly strange feeling when I received your letter
  11. since the most part of graphic formats that coerce can handle are used
  12. mainly in Japan. I don't know how popular `mag' or `pic' formats are
  13. out of Japan.
  14.   Anyway, it has no influence on my decision. I am enclosing an
  15. English version of the README file. I will appreciate any suggestions
  16. or comments. Thanks.
  17.  
  18. --
  19. Tatsurou Sekiguchi,
  20. Department of Information Science,
  21. Faculty of Science, University of Tokyo, Japan
  22. Email: cocoa@is.s.u-tokyo.ac.jp
  23.  
  24. ----------------------------------------------------------------------
  25. $ Revision: 1.00(English) $
  26.  
  27. coerce
  28. ------
  29. Coerce is a program for converting graphic formats mutually used in
  30. many Japanese BBS. To put it more precisely, it converts from one of
  31.  
  32.     mag,pi,pic,maki,ppm,pbm,ml1, and beta formats to one of
  33.  
  34.     mag,pi,pic,ppm, and beta formats.
  35.  
  36. `Beta format' is an inner representation of graphic images in coerce,
  37. which is very similar to VRAM images of X68000(SHARP) or
  38. FM-TOWNS(Fujitsu). The format is often used for debugging. `Coerce'
  39. is aimed to accelerate traffic of graphic images between BBS and
  40. Internet.
  41.  
  42. Environment
  43. -----------
  44. I verified that coerce worked correctly under the following
  45. environment:
  46.  
  47. Sun's workstations(SS1,SS1+,SS2,SS10) & SunOS 4.1.1/3 & gcc 2.4.5
  48.  
  49. ANSI C is needed to build this package. The initial Makefile uses
  50. `gcc'. I also packed a simple image viewer on X Window System in this
  51. package, which requires C++ to be compiled. I have been reported that
  52. coerce was complied successfully in MIPS & RISC/os 5.01 & gcc.
  53.  
  54. Files
  55. -----
  56. This package includes:
  57.  
  58. Beta.c        Maki.c        Pic.h        
  59. Beta.h        Maki.h        coerce.c
  60. ML1.c        PPM.c        common.c    
  61. ML1.h        PPM.h        defs.h    
  62. Mag.c        Pi.c        ximage.cc
  63. Mag.h        Pi.h        mkmains.c
  64. Makefile    Pic.c        readme
  65.  
  66. Building
  67. --------
  68. Only typing `make' is enough to compile all programs when you are in
  69. one of the above or similar environments. If it succeeds, it creates
  70.  
  71. pictomag pictopi pictoppm magtopic magtopi magtoppm makitopic makitomag
  72. makitopi makitoppm pitopic pitomag pitoppm ml1topic ml1tomag ml1topi
  73. ml1toppm ppmtopic ppmtomag ppmtopi pbmtopic pbmtomag pbmtopi
  74. coerce ximage
  75.  
  76. Examples
  77. --------
  78. Commands like `**to**' can be used as the same way as ones of pbmplus
  79. package. For instance, `magtopic' converts a `mag' format image
  80. `foo.mag' to a `pic' format one when you type as follows:
  81.  
  82.     % magtopic < foo.mag > foo.pic
  83.  
  84. `coerce' is a synthesis of all converters, which can be used as an
  85. alternative of each converter. For instance, in order to convert
  86. `mag' format to `pic' format, type
  87.  
  88.     % coerce -mag +pic foo.mag
  89.  
  90. Options of coerce:
  91. -{mag,pi,pic,maki,ppm,pbm,ml1,beta} specify the format of input images.
  92. +{mag,pi,pic,ppm,beta} specify the format of output images.
  93. -notadjust    prevents adjusting an aspect ratio of pixels for `pic'
  94.         format images.
  95. -stdin        indicates an input image is read from standard input.
  96. -stdout        indicates the result is sent to standard output.
  97. -o [name]    specified the output file name.
  98. -quiet        prevents messages from being written.
  99.  
  100. Options of ximage:
  101. -display [host]    specifies the X server to connect.
  102. -geometry [geometry]    specified the preferred position and size.
  103. -root        indicates that the image is put on the root window.
  104. -monochrome    forces the image to be displayed in monochrome.
  105. -diffusion    indicates to reduce colors in error diffusion method.
  106. -times [real]    specifies an expansion or compression factor for the image.
  107. -notadjust    prevents adjusting an aspect ratio of pixels for `pic'
  108.         format images.
  109. -xscale [real]    specifies an expansion or compression factor for the
  110.         image along X-axis.
  111. -yscale [real]    specifies an expansion or compression factor for the
  112.         image along Y-axis.
  113. -full        forces the image to expand up to the whole screen.
  114.  
  115. Porting
  116. -------
  117. Porting to other environments and other machines is welcomed. Any
  118. trial to incorporate new facility to save/load another format images
  119. is also welcomed. There is already a patch for `xv' which enables to
  120. load `mag' and `pic' format images. I think it is an interesting
  121. attempt to combine `coerce' with `xv'.
  122.  
  123. License
  124. -------
  125. `coerce' includes a part of source files of PiFM ver 0.16 which was
  126. written Takashi Nawashiro(PC-VAN PMH97000,NIFTY-Serve MAG03213). It is
  127. permitted by the document for me to use and redistribute it. I waive
  128. the copyright on this software. You can use/modify/redistribute this
  129. package freely, even for commercial purpose. I have no responsibility
  130. on any result caused by this software.
  131.  
  132. Acknowledge
  133. -----------
  134. I would like to thank Mr. Takashi Nawashiro who was kind enough to
  135. permit me to use and redistribute a part of source codes of PiFM. I
  136. also thank Mr. Hiramoto who tested `coerce' on MIPS.
  137.  
  138. Author
  139. ------
  140. `coerce' was programmed by Tatsurou Sekiguchi.
  141. Email: cocoa@is.s.u-tokyo.ac.jp
  142. ----------------------------------------------------------------------
  143.